ABSTRACT 

The Library File Editor is a utility program used to analyze the contents 
of a library file, to list titles in a library file, to merge libraries, to up- 
date libraries, to extract logical records from a library file, and to create 
new libraries selected from contents of system library files or written by 
the user. 



User's Manual 

LIBRARY FILE 
EDITOR 



093-000074-03 



TAPES 



Stand-alone Absolute Binary: 091-000057 

RDOS Dump: 088-000031 

SOS Relocatable Binary: 089-000081 

SOS Magnetic Tape: 071-000004 

SOS Cassette Core Image: 070-000002 

SOS Cassette RB: 070-000003 



Ordering No. 093-000074 

©Data General Corporation 1972, 1973, 1974 

All Rights Reserved. 

Printed in the United States of America 

Rev. 03, June 1974 



NOTICE 

Data General Corporation (DGC) has prepared this manual for use by DGC personnel, 
licensees and customers. The information contained herein is the property of DGC 
and shall neither be reproduced in whole or in part without DGC prior written approval. 

DGC reserves the right to make changes without notice in the specifications and materials 
contained herein and shall not be responsible for any damages (including consequential) 
caused by reliance on the materials presented, including but not limited to typographical 
or arithmetic errors. 



Original Release 
First Revision 
Second Revision 
Third Revision 



March 1972 
December 1972 
October 1973 
June 1974 



This document, 093-000074-03, supersedes 
093-000074-02 and constitutes a minor revi- 
sion to SOS sections. Changes are marked 
with a black line at the side of the page. 



TABLE OF CONTENTS 



CHAPTER I - USE OF THE LIBRARY FILE EDITOR 1-1 

CHAPTER 2 - STAND-ALONE OPERATING SYSTEM LFE 2-1 

Operation 2-1 

Commands 2-1 

Key Letters 2-1 

Command String Structure 2-2 

Device Names 2-2 

Record Names 2-3 

Switches 2-3 

Numeric Switches 2-3 

Letter Switches 2-3 

Command String Corrections 2-3 

^v/iinm*il.u J-fVUOXXLJLlWlliJ •••••■••••••••••••• »#Z< "**i 

Analyze (A) Command 2-4 

Delete (D) Command 2-7 

Insert (I) Command 2-8 

Merge (M) Command 2-10 

Replace (R) Command 2-11 

Title (T) Command 2-12 

Extract (X) Command 2-13 

Error Messages 2-14 

Caution Messages 2-17 

Operator Cues 2-17 

CHAPTER 3 - RDOS LIBRARY FILE EDITOR 3-1 

One rati on : q_i 

Commands 3-1 

Key Letters 3-1 

Command String Structure 3-2 

Switches 3-3 

Numeric Switches 3-3 

Letter Switches 3-3 

Command String Corrections 3-3 

Command Descriptions 3-3 

Analyze (A) Command 3-4 

Delete (D) Command 3-7 

Insert (I) Command 3-8 

Merge (M) Command 3-10 

New (N) Command 3-11 

Replace (R) Command 3-12 

Title (T) Command 3 -13 

Extract (X) Command 3-14 



CHAPTER 3 - RDOS LIBRARY FILE EDITOR (Continued) 

Error Messages 3-15 

Caution Messages 3-16 

INDEX 



ii 



CHAPTER 1 



USE OF THE LIBRARY FILE EDITOR (LFE) 



The Library File Editor provides a means of updating and interpreting librae files 
A library file (also called library ) is comprised of a set of relocatable binary files 
(produced by the Extended Assembler or by the Macro Assembler) that is denoted 
by special beginning and ending blocks. For example, 

LIBRARY START BLOCK 
progT.RB 



p_rog n . RB 

LIBRARY END BLOCK 



vvncre each pj. o^ . ivB represents une of a set of relocatable 
binary programs. 



Library START and END blocks are described in the Extended Relocatable 
Loaders Manual (093-000080). Library tapes are supplied with the DGC opera- 
ting systems and with subsystems such as ALGOL and FORTRAN. 

The LFE allows the user to analyze the contents of a library file, to list titles in a 
library file, to merge libraries, to update libraries, to extract logical records from 
a library file, and to create his own library files, selected from the contents of sys- 
tem library files or written by the user. The LFE is of special importance in order- 
ing and reordering of relocatable programs in a library file, since 'the order in which 
the programs appear determines which programs will be loaded. This is because of 
the mechanism employed by the relocatable loader when it operates on library files. 

Selection of any program for loading is triggered by the occurrence of a global entry 
within the program that resolves an external declaration within a previously loaded 
program. This means that if program A on library file 1 has been loaded and con- 
tains a call to program B on library file 1, then B must be located physically after 
A on the file in order to be loaded. If there are no unresolved external symbols de- 
fined as entries in the relocatable binary program and thus no calls to the program, 
the program is not loaded. See the Extended Relocatable Loaders Manual, 093-000080, 
for additional information on selective loading of library routines. 

In some cases it may be necessary to provide two or more copies of a given program 
on a library file to insure proper referencing. For example: 
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Program A calls-* 13 calls -*C calls -*A 

(Assume that C follows A in the library file. ) If a previously loaded program has 
called A, then A, B and C are loaded via the standard mechanism. However, if a 
previously loaded program has called B, then only programs B and C would be 
loaded. For this case, a second copy of program A should be placed after program 
C. One of the LFE commands, Analyze (A), allows the user to determine whether 
the programs on the file are the proper selection and in the correct order for his 
purposes, since the command causes listing of global declarations of the library file. 

The LFE is supplied in three forms for stand-alone operation: absolute binary 
(tape 091-000057, relocatable binary (tape 089-000081), and core image files on 
cassette and magnetic tape. The core image form is included on a master tape for 
stand-alone system operation from cassette or magnetic tape. The LFE is supplied 
as a dump tape under RDOS (tape 088-000031). 



All forms of the LFE operate in nearly identical fashion, their principal differences 
AjCiiiQ^ luC ways in wniCn mCy cGiriiTiUniCcJ 
operator cues, command format, etc. ) 



UCLllfcl Lll^» VVCtVO J-l-L VVJ.1XV-J.1 L11WV V^\JlinilUllH_ULV Willi t±±v* v-'j-zw-L. <-*•(, \SJ- ^wj-J-V-l. m.^uui^.^^uj 



The Stand-alone Operating System LFE is described in Chapter 2, and the RDOS 
LFE is described in Chapter 3. 

The terminology used to describe the relocatable binaries that make up a library 
is as follows: 

logical record - A relocatable binary record contained within 
a library is called a logical record. 

binary - Outside the library file, the relocatable binary 

may be a separate file called a binary . A binary 
may be produced by extracting one or more relo- 
catable binary records from a library or can be 
the output of an assembly. 

update - A binary that is to be inserted into a library, 

either to replace a current logical record or 
to create a new logical record, is called an • 
update. 



1-2 



CHAPTER 2 

STAND-ALONE OPERATING SYSTEM LFE 

The Stand-alone Operating System LFE is supplied in the following forms: 

Tape 091-000057 - Absolute binary tape for paper tape configurations that 

use the absolute binary loader. 

Tape 089-000081 - Relocatable binary tape for SOS configurations that 

use the relocatable binary loader. 



Users having SOS cassette or magnetic tape systems are supplied with system 
programs on cassette or magnetic tape in both relocatable binary and core image 
format. The core image LFE can be loaded with the core image loader. 

j. or j.urtner information on loading LFj^, see the apprupriu.it: manual: Binary Loader 
093-000003; Extended Relocatable Loaders 093-000081; Stand-alone Operating 
System 093-000062. 

OPERATION 

When either tape 091-000057 or 089-000081 is loaded with the appropriate loader, the 
LFE issues the prompt LFE and the user types a command string. The user types in 
command strings on the console keyboard. Error, caution, and prompting messages 
are issued by the LFE to the console output. 



COMMANDS 



Key Letters 



Each command string begins with a key letter that indicates to the LFE what operation 
is to be performed on the arguments that follow the key letter. The following table 
lists the key letters and the commands they represent: 

Key Letter Command 

A Analyze a set of library files and/or binaries, 

or analyze selected records in a library* 

D Delete logical records from a library. 

I Insert binaries into either a new or an existing 

library. 

M Merge a library and binaries to form a new library. 

R Replace logical records in a library with new binaries. 
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COMMANDS (Continued) 

Key Letters (Continued) 

Key Letter 

T 
X 

Command String Structure 



Command 



List titles in a set of libraries or binaries. 
Extract specific logical records from a library, 



A command string begins with a key letter followed by arguments. Arguments can be 
either device names or logical record names. Arguments are separated by at least 
one space; additional spaces are ignored. 

An argument may have one or two switch options. A switch is indicated by a / following 
the argument; the / is immediately followed by a letter or a number. 

Each command string is terminated by a carriage return ( } ). Command strings can 
be extended beyond one line by typing SHIFT N ( O immediately before the carriage 
return. The teletypewriter echoes a carriage return /line feed and the command string 
can be continued. Only one key letter is permitted per command string. 
Typing control A at any time aborts the current operation and causes the LFE to output 
the prompt LFE. 

Typical command string structure is: 

key letter devicename /switch recordname j 
Device Names 

The following device names are recognized by the stand-alone LFE: 

Device Name Device Description 



$TTP 

$TTO 

$TTI 

$LPT 

$PTR 

$PTP 

$TTR 

CTx:yy* 

MTx:yy* 



Teletype punch output 
Teletype printer output 
Teletype keyboard input 
Line printer output 
Paper tape reader input 
Paper tape punch output 
Teletype reader input 
Cassette tape drive 
Magnetic tape drive 



x stands for a number in the range 0-7 representing the tape drive selected; 
yy stands for a number in the range 0-99 representing the tape file selected. 
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COMMANDS (Continued) 

Record Names 

Record names are those names assigned to relocatable binary records by the . TITL 
pseudo-op. Only the first five characters in a record name are meaningful. 

Switches 



Arguments may be modified by switches. A switch is indicated by a right slash ( / ) 
followed by either a letter or a decimal digit. A blank space between the switch indi- 
ratnr I and the arfiiment it modifies is ODtional. However, no sDace is Dermitted 
between the slash and the letter or number following. 

Numeric Switches 

Mumorin oiirii-^Vigg specif" ths number of times that the previous argument is to be re- 
peated. For example: 

$PTR/2 ) 

is equivalent to $PTR $PTR. A numeric switch of one (/l) is the same as no switch. 
Numeric switches will be indicated by /# in the descriptions of specific commands. 

If two numeric switches are associated with an argument, only the more recent one 
will be accepted. For example, $PTR/3/2 is equivalent to $PTR/2. 

Letter Switches 

Letter switches have distinct meanings that depend upon the arguments they modify 
and the command strin°" in which thev are founds All allowable letter switches will 
be explained in the descriptions of specific command functions. 

Arguments having switches /I (input library), /L (listing switch) or /O (output switch) 
can be situated anywhere in the command string following the key letter. 

Command String Corrections 

An entire command string can be deleted by typing SHIFT L (\). Single characters in 
a command string can be deleted by depressing RUBOUT. The most recently entered 
command string character will be deleted each time RUBOUT is depressed, and the 
back arrow " — " will be printed once per deletion. If the first character in a com- 
mand string is deleted, the standard prompt LFE will be printed, indicating that the 
program is ready to accept a new command string. For example : 

D $PTR — — — is equivalent to D $ . 

D $PTR — — — *- *- «- deletes the entire command string, causing the prompt I 

LFE to be output. 
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COMMAND DESCRIPTIONS 

Following are definitions and descriptions of each of the Library File Edit commands. 
Extra switches not specified in the format are generally ignored. Optional switches 
and arguments are enclosed in square brackets in the specification of command string 
format. 

Command: Analyze (A) 

Purpose: The Analyze command itemizes the global declarations of a library file, 

of specific logical records within a file, or of single relocatable binary 
records. Records are analyzed in the order of their appearance during 
the serial scanning of the input. 

An analysis produces the following output: 

1. Listing of all global declarations (symbol, symbol type, and 
flags). 

2. Cross-reference of all external records in the file called b T7 
each analyzed record. 

3. Title of the module containing each external record referenced 
by the analyzed record. 

4. Count of ZREL and NREL locations required by each analyzed 
record. 

At the end of a library analysis a total count of all needed ZREL and NREL 
locations is given. (The total count given after a single binary analysis 
is the same as the count named in 4 above. ) 

Symbol types are: 

T - Title of record 

ED - Entry Displacement (must be referenced by an external 

displacement. ) 

EN - Entry Normal (must be referenced by an external normal) 

EO - Entry Overlay (must be referenced by an external normal) 

D - External Displacement 

N - External Normal 

Each entry containing either a definition error or phase error is also 
flagged. Symbol flags are: 

M - Multiply defined entry (note that symbol definitions must be 
unique in their first five characters). 
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Analyze (A) Command (Continued) 

U - 



Format: 



Switches: 



Examples: 



Undefined entry (an external normal or external 
displacement references an undefined entry). 

Phase error (an external normal or external dis- 
placement whose entry was defined before the 
external reference). 



A [ listingname /Lj inputname [/B] [/#].. .[ recordname [/R]. . . 

where: listingname is the name of the device used to output the 
analysis^ 

inputname is the name of the input device which reads 

w-^-w — j-j.*^*.^. j.wtj VJ _ xj.J-»J.tJ.J.X^kJ LU AJ\_ QU.LCLX y Zi^U, 

recordname specifies a particular logical record in 
the input library to be analyzed. 



/B 



/L 
/R 

/# 



Binary record switch, indicating that one or more bi- 
nary records is to be read on the input device. Absence 
of /B in the inputname indicates that one or more 
libraries will be read. 

Listing switch, indicating that the listingname device will be used 
to output the analysis. Absence of this switch causes outputto the 
$TTO by default. 

Record switch, the logical recordname preceding the 

SWl'trh Will h<=> anal\77Prl t-n the* ovpln ci"/~.n nf tJin n-hUr^-r- 

logical records in the library. 

Number switch, indicating how many binary records or 
libraries will be read. 



A $TTO/L $PTR ABC/R ), 



causes logical record ABC, in a library loaded on the 
high speed reader, to be analyzed. The analysis will 
be output on the TTY printer. 



A $PTR ABC/R CDE/R \, 



causes logical records ABC and CDE, in a library loaded 
on the high speed reader, to be analyzed. The analysis 
will be output on the TTY printer by default. 
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Analy ze (A) Command (Continued) 



Output: 



The following is a sample of output generated by the A Command. 



LFE A SPTR STTO/L 

LOAD SPTR, STRIKE ANY KEY. 

T RESID 

EN RBIN 

EN RLIN 

EN WRIB 

EN WRLI 

ED RTRN 0VLA1 0VLA2 

ED SAVE OVLAl 0VLA2 

ED STBT OVLAl 0VLA2 

ED LD3T OVLAl 0VLA2 

ED K30 0VLA2 

ED K10 0VLA2 
U N BEND 
U N BTAB 
U N RLOC 
U N 0VLA3 

N 0VLA2 OVL2 

N OVLAl OVL1 
PAGE HERO RELOCATABLE DATA * 000166 
NORMAL RELOCATABLE DATA » 001700 



P 
P 

P 
P 



T OVL1 
EO OVLAl 
D STBT 
D LDBT 
N RTRN 
N SAVE 



RESID 
RESID 
RESID 
RESID 
RESID 



PAGE ZERO RELOCATABLE DATA » 000000 
NORMAL RELOCATABLE DATA ■ 000336 



P 
P 
P 
P 
P 
P 



T 0VL2 
EO 0VLA2 
D LDBT 
STBT 
K30 
K10 
RTRN 
SAVE 



D 
D 
D 
N 
N 



RESID 
RESID 
RESID 
RESID 
RESID 
RESID 
RESID 



}' 



PAGE ZERO RELOCATABLE DATA - 000000 \ 
NORMAL RELOCATABLE DATA » 000322 f 



Title 

Entry Overlay 

External Displacement 

External Normal 

Locations Count 
for OVL2 



TOTAL 2REL COUNT t 000166 
TOTAL NREL COUNT t 002560 



Total Locations Count 



LFE 
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Command: 



Delete (D) 



Purpose: 



Format: 



iO uCiete one o± more logical records from a library. 

D inputname /I outputname /Q recordname [ recordname . . . ] 

where: inputname is the name of the device containing the 
librarv whose selected loo-iral rprnrHnam<=/ai win 



be deleted; 



outputname is the name of the device which will 
produce the new library. 

Switches: /I Jnput library file switch specifying the device which 

will read the existing library. 

/O Output library file switch naming the device which 

will produce the new library. 

Example: D $PTR/I $PTP/0 ABC DEF } 

causes logical records ABC and DEF to be deleted 
from the input library file, with the resulting li- 
brary output on the high speed punch. 
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Command: Insert (I) 

Purpose: To insert binaries into an existing library or to create a new 

library. 

Format: I [ inputname /I] outputname /O [ insertname [/#] . . . ] 

[ recordname /A insertname [/#]. ..]... 
[ recordname /B insertname[ /#]. ..]... 

where: inputname is the name of the device to read in the 
existing library; 

outputname is the name of the device producing the 
new library; 

insertname is the name of the device reading in the 
binaries which are to be inserted; 

recordname is the name of the logical record (in 
the existing library) before or after which the in- 
sertions will occur. 



Switches: 



/I 



Input switch, labeling inputname . If no inputname 
argument is specified, no logical record names 
may appear and all updates are read in the order 
given to become the new library file. 



/# 



Numeric switch indicating the number of binaries 
which will be inserted. 



/O Output switch identifying the outputname device. 

/A After switch naming the logical recordname after 

which insertions will occur. 

/B Before switch naming the logical recordname before 

which insertions will occur. 

When a record specified by an A or B switch is retched, a 
prompting message naning the logical record will be issued 
before any updates are accepted. 

Examples: I $PTP/0 $PTR/3 > 

causes three relocatable binary records mounted 
on the high speed reader to be punched as a library 
file by the high speed punch. 
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Insert (I) Command (Continued) 

I MT0:3/I $PTP/0 $PTR ) 

causes one relocatable binary record from file number 3 on mag- 
netic tape drive number to be added to the bemnnino- nf a lihra™ 
file, with the new library file punched on the high speed punch. 

I $PTR/I $PTP/0 M/A $PTR ) 

causes a library to be updated with binaries. If the input library 
consists of logical records L, M, a ; id N, and the update record is 
Q, is inserted after record M. The result is an updated librar" 
consisting of records L, M, Q, and N. The new library is punched I 
on the high speed punch, and the high speed reader is the single 
input device. 

Caution : If [ insertname [ /# ] . . . ] is used with no preceding recordname , all 

apddi.v,o i<-a.u j.j.1 via iruo ucviw win jjc inserted ai tne oeginning ot tne 
new library file. 

If inputname is the same as insertname , the input library master must 
be reread from the beginning of the file after insertion has occurred. 
Logical records which were read before insertion will be ignored. 

All the insert options ( /A, /B, etc. ) may be used in the same command 
string, but the same recordname cannot be used more than once in an 
insert command string. 
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Command: 

Purpose: 

Format: 



Switches: 



Merge (M) 

To combine binaries and/or libraries into one library. 

M outputname /Q inputname [/Bl[/#]. . . [inputname [/B] [/#]]. . . 

where: outputname is the name of the device which will 
produce the new library; 

inputname is the name of the device which will 
read in the binaries or libraries to be merged. 

/O Output library file switch, naming the device which 

is to output the new library file. 

/B Binary switch, labeling the inputname device which 

will read in update binaries. If /B is omitted, 
libraries will be read by the inputname device. 

/# Numeric switch, detailing the number of libraries 

or binaries which will be merged. 



Examples; 



Caution: 



M $PTP/0 $PTR $PTR/B > 

causes one binary record to be added to the end of 
a library file. The new library file is punched by 
the high speed punch. 

M CTl:23/0 $PTR/3 $PTR/B/2 ), 

causes three libraries to be input, then two binaries, 
forming a new library output as file number 23 on 
cassette drive number 1. 

Libraries and binaries must be input in the order they are speci- 
fied in the command string. 
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Command: Replace (R) 

Purpose : To replace logical records in a library file with new binaries. 

Format: R inputname /I outputname /O recordname updatename 

[ recordname updatename ] . . . 

where: inputname is the name of the device containing the 
existing library; 

outputname is the name of the device which will out- 
put the new librarv: 



Switches: 



Example : 



Cautions: 



/I 
/O 



recordname is the name of the logical record in the 
existing library which will be replaced; 

updatename is the name of the device which will read 
the update. 

Jnput library switch, naming the device to read in 
the existing library. 

Output library switch, naming the device which will 
produce the new library. 



R $PTR/I $PTP/0 RE CI $PTR > 

causes a library file, input on the high speed reader, 
to have one of its logical records (REC1) replaced by 
an update input via the high speed reader. The new 
library will be punched on the high speed punch. 

Before reading in each update, the name of the cor- 
responding logical record to be replaced will be given 
in a prompting message. 

Update recordname s and their associated updatename devices 
must be given in pairs in the command string. Record replacement is 
accomplished in the order that the updates are read in. 
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Command: 

Purpose : 

Format: 



Switches: 



Title (T) 

To produce a title (. TITL) listing of binaries or libraries. 

T r outputname /L] inputname [/B] [/ft]. . .f inputname [/B] [/ft]] 

where: outputname is the name of the device which will 
produce the listing; 

inputname is the name of the device which will 
read in the library or binary. 

/L Listing switch, indicating the device which will 

produce the listing. Absence of /L causes the 
$TTO to be selected by default. 

/B Binary switch, labeling the inputname device which 

will read in one or more binaries. If /B is omitted, 
libraries will be read by the inputname device . 

/# Numeric switch, indicating how many libraries or 

binaries will be input. 



Example : 



Caution : 



T $PTR ^ 

causes the titles of all logical records in the library 
file (mounted on the high speed reader) to be printed. 
Since no listing device is given, the teletype printer 
is selected by default. 

Titles will be listed in the order of their appearance on the 
inputname device(s). 
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Command: eXtract (X) 

Purpose: To extract a copy of a logical record from a library file. 

Format: X inputname/ 1 outputname/ O recordname 

where: inputname is the name of the device to read in the 
library; 

outputname is the name of the device which will 
produce a copy of the extracted record. 

recordname is the name of the logical record which 
will be extracted. 

Switches: /I Jnput switch, labeling the inputname device. 

/O Output switch, labeling the outputname device which 

will produce a copy of the extracted record. 

Example: X $PTR/I $PTP/0 ABC ), 



causes logical record ABC to be extracted from its 
library file. The library file is input on the high 
speed reader; record ABC is punched by the high 
speed punch. Output will be a binary. 
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ERROR MESSAGES 

Errors may occur due to an improper command string or during the attempted execu- 
tion of a command. Messages are issued to flag errors of both types. If an error con- 
dition is noted in the command string, an error message will be issued as soon as the 
string terminator ( ) ) is detected. No output will result. 

ILLEGAL KEY: followed by input illegal key. 

First typed letter (key) does not match any of the available com- 
mands. Example: 

C $PTR ) 

t 

SWITCH ERROR: followed by argument with faulty switch. 

A switch not permitted by the command format is detected. 
Example: 

T $PTR/R > 
t 

TOO MANY ARGUMENTS IN COMMAND LINE 

The command line buffer (200g characters) has been exceeded. 

NO INPUT FILE? 

Command requires an input device and none was specified. 
Example: 

D $PTP/0 ABC ) 

NO OUTPUT FILE? 

Command requires an output device and none was specified. 
Example : 

X $TTR/I ABC ) 

If an error condition is detected during the execution of a command, an error message 
is output. The error message also attempts to name the file/device responsible for the 
error. If a library file is being output, it will be closed with an end block. The following 
list summarizes the command execution errors. 
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ERROR MESSAGES (Continued) 



ERROR CONDITION IN INPUT FILE: 
inputname 

Faulty name assigned to device which will read the input. Example: 

T $TTO/L $PTI ^ 
t 

ERROR CONDITION IN OUTPUT FILE: 
outputname 

Faulty name assigned to device which will punch the output file. 
Example: 

I $PPP/0 $PTR/3 ) 
t 

ERROR CONDITION IN UPDATE FILE: 
updatename 

Faulty name assigned to device which will read in the update re- 
cord. Example: 

R $PTR/I $PTP/0 DATAB $PTI ^ 

t 

ERROR CONDITION IN LISTING FILE: 
listingname 

Faulty name specified for listing device. Example: 

T $TOT/L $PTR p 
t 

CHECKSUM ERROR IN LOGICAL RECORD: 
recordname 

The paper tape logical record has been damaged or incorrectly 
punched. 

CHECKSUM ERROR IN UPDATE FILE: 
updatename 

The paper tape update file has been damaged or incorrectly punched. 
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ERROR MESSAGES (Continued) 

BLOCK ERROR IN UPDATE FILE: 
updatename 

Format of input block was improper. For example, library read 
in as an update when relocatable record was called for. 

BLOCK ERROR IN LOGICAL RECORD: 
inputname 

Logical record format error. For example, attempt to list a 
series of binary records, library file input by mistake. 

LOGICAL RECORD NOT RECOVERABLE: 
recordname 

A device is shared by both the input library and an update record. 
The second reading of the input file differs from the first reading. 
For example, the input library and the update record share a com- 
mon input device. An attempt is made to replace one record in a 
master file. During the second pass of the input file, the wrong 
master is read. 

UPDATE FILE NOT FOUND FOR L. R : 

R command format requires both a recordname and an updatename . 
One or both is missing. For example: 

R $PTR/I $PTP/0 ABC } 

SYMBOL TABLE OVERFLOW 

During execution of an Analysis, insufficient core memory is 
available for the symbol table. 

UNEXPECTED ERROR FROM SYSTEM 

Hardware malfunction has occurred. 

If an error occurs while a library start block is being read, the appropriate error 
message will be followed by " LB. ST" instead of a file or record name. 

If no particular file or record device name can be associated with an error condition, 
an error message will be output followed by a blank line. A typical error causing this 
condition is the presence of a control character in a device name: (form feed) $PTR. 
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CAUTION MESSAGES 

Two caution messages are available to signal the presence of non-fatal error conditions. 
In the T or A commands, if no listing device is named, the message: 

NO LISTING FILE: DEFAULT LISTING ON TTO 

is output and the teletypewriter is used for the listing device. 

If any of the record names appearing in an argument list is not found: 

LOGICAL RECORD NOT FOUND: 
recordname 

is output. 

The above caution messages may indicate non-fatal errors in the command string. Such 
errors might produce commands which are executable, yet whose operation differs from 
what was intended, 

OPERATOR CUE MESSAGES 



The program provides several messages to prompt operator action during use of the 
editor. LFE is output at the left hand margin to indicate that the program is ready to 
accept operator commands. 

Before any input device is activated, the message: 

LOAD devicename , STRIKE ANY KEY. 

is issued. This message may be preceded by a single word line indicating whether an 
INPUT or UPDATE device is referred to by the load message. 

When an update record is to be read in the same device which inputs the library file (in 
an insert or replace command) the message: 

REMOVE INPUT MASTER AND LOAD U. F 

is issued. After the update record has been read in, the library file must again be read. 
The message: 

REMOVE U. F AND LOAD BACK INPUT MASTER 
is issued. The library file should be loaded at the beginning. The message: 
LOAD inputname , STRIKE ANY KEY. 
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OPERATOR CUE MESSAGES (Continued) 

is issued and carried out; the input device reads from the start of the library. Any 
logical records on the file which have already been processed by the editor will be 
ignored. 

In both the Insert and Replace operations, the logical record name is printed which was 
read just before operator action is required. 
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CHAPTER 3 

RDOS LIBRARY FILE EDITOR 

The RDOS LFE is supplied as dumped tape, 088-000031 and has the name LFE.SV. To 
use the LFE, the user must create a save file from the tape using the LOAD command, 
e. s, . 



LOAD $PTR ) 



OPERATION 



The operator communicates with the LFE through the command line interpreter (CLI). 
When the CLI prints its ready prompt (R) on the teletype an LFE command string may 
be typed on the teletypewriter by the operator. 

The LFE command string is used to build a command file (COM. CM). When a command 
line begins with the file name LFE, the CLI sorts the command lines and creates 
COM. CM in the format eiven below. 



LFE 



null 



error , local 
file i switches 
(output)' 



output- ' local 
master , switches 
(output) ' 



listing 1 local 
file , switches 
(output) • 



key 
(input) 



local 
switches 



argu-' local 
ments , switches 
(input) ' 



Error and caution messages are issued by the program on the console output. 

COMMANDS 

Key Letters 

Each command string starts with the CLI command "LFE" followed by a single LFE 
command key letter. This key letter indicates what operation is to be performed on 
the arguments that follow the key letter. The following table lists the key letters and 
the commands they represent. 



Key Letter 

A 

D 

I 

M 

N 



Command 

Analyze a set of library files or binaries or analyze 
selected records in a library. 

Delete logical records from a library. 

Insert binaries into either a new or an existing library. 

Merge a library and binaries to form a new library. 

Create a new libra 17 from one or more binaries. 
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COMMANDS (Continued) 

Key Letters (Continued) 

Key Letter Command 

R Replace logical records in a library with new binaries. 

T List titles in a set of libraries or binaries. 

X Extract specific logical records from a library. 

Command String Structure 

An LFE command string consists of "LFE" followed by a command key letter followed 
by arguments. Arguments can be file names or logical record names. Arguments are 
separated by at least one space; additional spaces are ignored. 

An argument may have one or two switch options. A switch is indicated by a / following 
the argument; the / is immediately followed by a letter or a number. 

Each command string is terminated by a carriage return ( ^ ). Typical command string 
structure is: 

LFE keyletter filename / switch recordname ). 

The following five rules apply to LFE command strings and to the commands involved. 

1. Only one command key may be given per command string. 

2. An input library file and an update file cannot reside on the same de- 
vice, for example, the $PTR. Both can, of course, be on disk. 

3. An input file is searched for in the specified RDOS directory as 
inputname. LB; if not found, a search is made for inputname. 

4. An update file is searched for in the specified RDOS directory as 
filename . RB (or . LB when using A, M, or T command keys), if not 
found, a search is made for filename . 

5. All references to logical records are satisfied by the first matching 
five -character title of a logical record in the library file. Therefore, 
it is strongly recommended that each logical record on a file have a 
unique title. 

Command strings can be extended beyond one line by typing SHIFT N ( t ) immediately 
before the carriage return ( \ ). 

Only one key letter is permitted per command string. 
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Switches 

Arguments may be modified by switches. A switch is indicated by a right slash (/ ) 
followed by either a letter or a decimal digit. A blank space between the switch indi- 
cator (/ ) and the argument it modifies is optional. However, no space is permitted 
between the slash and the letter or number following. 

Numeric Switches 

Numeric switches specify the number of times that the previous argument is to be 
repeated. For example: 

$PTR/2 I 

is equivalent to- $PTR $PTR. A numeric switch of one (/l) is the same as no switch. 
Numeric switches will be indicated by /# in the descriptions of specific commands. 

Letter Switches 

Letter switches have distinct meanings that depend upon the arguments they modify 
and the command string in which they are found. All allowable letter switches will be 
explained in the descriptions of specific command functions. Arguments having 
switches /I (input library), /L (listing switch), or /O (output switch) can be situated 
anywhere in the command string following the key letter. 

Command String Corrections 

An entire command string can be deleted by depressing SHIFT L ( \ ). Single characters 
in a command string can be deleted by depressing RUBOUT. The most recently entered 
command string character will be deleted each time RUBOUT is depressed, and the back 
arrow " — " will be printed once per deletion. 

For example: 

LFE D $PTR — — — is equivalent to D $. 

LFE D $PTR ———————— —-—deletes the entire command string. 

LFE D $PTR\ deletes the entire command string. 

COMMAND DESCRIPTIONS 

Following are definitions and descriptions of each of the seven Library File Edit com- 
mands. Extra switches not specified in the format are generally ignored. Optional 
switches and arguments are enclosed in square brackets in the specification of command 
string format. 
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Command: Analyze (A) 

Purpose: The A command itemizes the global declarations of a library file or 

of specific logical records within a library file. Records are analyzed 
in the order of their appearance during the serial scanning of the input. 
An analysis produces the following output. 

1. The name of the library, printed at the start of analysis. 

2. Listing of all global declarations (symbol, symbol type, 
and flags). 

3. Cross-reference of all external records in the file called by 
each analyzed record. 

4. Title of the module containing each external record refer- 
enced by the analyzed record. 

5. Count of ZREL and NREL locations required by each ana - 
lyzed record. 

At the end of a library analysis a total count of all needed ZREL and 
NREL locations is given. (The total count given after a single binary 
analysis is the same as the count named in 5 above. ) 

Symbol types are: 

T - Title of record 

ED - Entry displacement ( must be referenced by .EXTD) 

EN - Entry Normal (must be referenced by . EXTN) 

EO - Entry Overlay 

D - External Displacement 

N - External Normal 

Each entry containing either a definition error or phase error is also 
flagged. Symbol flags are: 

M - Multiply defined entry (note that symbol definitions 

must be unique in their first five characters. ) Refer- 
ences to multiply defined entry names are preceded 
by an asterisk (*). 

U - Undefined entry (an external normal or external dis - 
placement references an undefined entry). 

P - Phase error (an external normal or external displace- 

ment whose entry was defined before the external ref- 
erence. ) 
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Analyze (A) Command (Continued) 



Format: 



LFE A [ listingname /L] inputname [ recordname] . 
LFE A/M [ listingname /L inputname inputname. . 



^witcnes : 



Examples: 



Output: 



where: listingname is the name of the file into which the 
analysis is to be written; 

inputname is the name of the file from which the 
input is read; 

recordname specifies a particular logical record in 
the input library to be analyzed. 

/M - Multiple input library files. The switch modifies the 
command key A and causes all file names following, 
with the exception of a listino- file, to be analyzed as one 
library. 

/F - Form feed. Each logical record analysis is on a 
separate page. 

/L - Listing file. By default the analysis is listod on $LPT. 
The switch causes the file preceding to be used for 
listing. 

LFE A/M MATH1.LB MATH2. LB $LPT/L^ 

The library files MATH1. LB and MATH2. LB are analyzed as 
one library and the results are printed on the line printer. 
(Note that recordname may not be used with switch M. ) 

LFE A DPI :M. LB 

The input file is M. LB in directory DPI. All the logical records 
in this library file are analyzed and the results are printed on 
$LPT (default listing file). 

LFE- A MATH. LB SIN COS TAN $LPT/L X / 

The input file is MATH. LB. The logical records SIN, COS, 
and TAN are analyzed and the results are printed to the line 
printer, $LPT. 

The following is a sample of output generated by the A 
command. 
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Analyze (A) Command (Continued) 

LFE A AEL.LB STTOI/L 
AEL.LB 





T 


RES ID 








EN 


RBZN 








EN 


RLIN 








EN 


VRIB 








EN 


VRLI 








ED 


RTRN 


OVL1 


0VL2 




ED 


SAVE 


0VL1 


0VL2 




ED 


STBT 


OVL1 


0VL2 




ED 


LDBT 


OVL1 


0VL2 




ED 


K30 


0VL2 






ED 


K10 


0VL2 




u 


XN 


BEND 






u 


XN 


BTAB 






u 


XN 


RLOC 






u 


XN 


0VLA3 








XN 


0VLA2 


0VL2 






XN 


OVLA1 


OVL1 





PAGE ZERO RELOCATABLE DATA - 000166 
NORMAL RELOCATABLE DATA • 001700 





T 


OVL1 






EO 


OVLA1 


RESID 


p 


XD 


STBT 


RESID 


p 


XD 


LDBT 


RESID 


p 


XN 


RTRN 


RESID 


p 


XN 


SAVE 


RESID 



PAGE ZERO RELOCATABLE DATA » 000000 
NORMAL RELOCATABLE DATA ■ 000336 





T 


0VL2 






EO 


0VLA2 


RESID 


p 


XD 


LDBT 


RESID 


p 


XD 


STBT 


RESID 


p 


XD 


K30 


RESID 


p 


XD 


K10 


RESID 


p 


XN 


RTRN 


RESID 


p 


XN 


SAVE 


RESID 



PAGE ZERO RELOCATABLE DATA - 000000 
NORMAL RELOCATABLE DATA ■ 000322 

TOTAL ZREL COUNT ■ 000166 
TOTAL NREL COUNT ■ 002560 
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Command : 

Purpose : 

Format: 



Switches: 



Delete (D) 

To delete one or more logical records from a library. 

LFE D inputname outputname /Q recordname [ recordname . . . ] 

where: inputname is the name of the file containing the library 
whose selected logical recordname (s) will be deleted; 

outputname is the name of the device that will produce the 
new library. 

/O 



Output masfpr libr^T-w file The cwiivVi mnct aT^T-nr^ m^- 
ify the name of the output library file, which can appear 
anywhere within the command line. 

Example: LFE D $TTR UTIL.LB/O MOVE LDBYT STBYT DIVI MULT COMP ^ 

The input file is $TTR. 

The output file is UTIL.LB . 

The logical records deleted from the input file are: 

MOVE 

LDBYT 

STBYT 

DIVI 

MULT 

COMP 
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Command: 



Purpose : 



Format: 



Insert (I) 

The I command permits a merger of update files and logical records 
on an input library file to produce an output library file. 

By default, update files in the order listed in the command will be 
inserted before the first logical record in the input file. To insert 
an update file or files before or after a given logical record, use the 
/A or /B switches as described below. A given logical record may 
appear only once in a command. 

No local symbols present in the update files are transferred to the 
output file. 

LFE I [ inputname ] outputname /O [ insertname ...]... 

[ recordname /A insertname . ..]... 
[ recordname/B insertname . . . ] ... 



Switches: 



Example : 



where: inputname is the name of the file from which the existing 
file is taken; 

outputname is the name of the file to contain the new library; 

insertname is the name of a file from which binaries are 
taken for insertion; 

recordname is the name of a logical record in the existing 
library before or after which insertions are to be made. 

/A Insert after. The switch appears after a logical record 

name in the argument list of the command line. Arguments 
following the switch are inserted after the logical record 
whose name precedes the switch. 

/B Insert before. The switch appears after a logical record 

name in the argument list of the command line. Arguments 
following the switch are inserted before the logical record 
whose name precedes the switch. 

/O Output library file. The switch must always modify the 

name of the output library file. 

LFE I $FTR MATH.LB/O A.RB B.RB SINE/A C.RB D.R B COS/A \), 

X.RB Y.RB Z.RB^ 
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Insert (I) Command (Continued) 



inputname is $PTR. outputname is MATH.LB. Files A.RB and 
B. RB are inserted at the beginning of the output file. Files C.RB 
and D.RB are inserted after the program SINE in the output file. 
Files X.RB, Y.RB and Z.RB are inserted after the program COS in 
the output file. (Note that SINE need not precede COS on the input 
file. ) 
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Command: Merge (M) 

Purpose : To combine libraries into one library. 

Format: LFE M outputname /O inputname [ inputname ...] 

where: outputname is the name of the file to receive the new library, 

inputname is the name of a file from which a library is to be 
taken to be merged. 

Switches: /O Output library file switch, naming the file that is to receive 

the new library. 

Examples: LFE M FORT.LB/O FORT1.LB FORT2.LB FORT3.LB FORT4.LB ^ 

The four FORTRAN library files are merged into a single 
FORTRAN library file called FORT.LB . 
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Command: 



Purpose : 



Format: 



Switches: 



New (N) 

To create a new library file named outputname from one 
or more relocatable binary files. 

LFE N outputname /O inputname [ inputname . . . ] 

where: outputname is the name of the file to receive the new library; 

inputname is the name of the file containing a relocatable 
binary to be included in the new library. 

/O Output library file. The switch always modifies the output - 

name file. 



Example : LFE N $PTP/0 $PTR/9/9/l A.RB C.RB ^ 



The output is a file punched to the $PTP. The update relo- 
catable binary files that comprise the output are 19 files 
taken from the $PTR followed by files A. RB and C. RB 
from the default directory device. 



3-11 



Command: Replace (R) 

Purpose : To produce an output file, replacing logical records in 

the input file with relocatable binary update files. 

No local symbols present in the update files are transferred to the 
output master. 

Format: LFE R inputname outputname /O recordname updatename t ^ 

[ recordname updatename] . . . j 

where: inputname is the name of the file containing the existing 
library; 

outputname is the name of the file that is to receive the new 
library; 

recordname is the name of a logical record in the existing 
library that is to be replaced; 

updatename is the name of the file from which a binary 
update is to be taken. 

Switches: /O Output library file. The switch always modifies the 

outputname file name. 

Example: LFE R MATH.LB MT0:^O ATAN $PTR TAN TAN.RB HSINE t ) 

$PTR ACOS X.RB^ 

The input file is MATH.LB. The output file is MT0:2. Logical 
record ATAN is replaced by a file mounted in the paper tape 
reader, $PTR. Logical record TAN is replaced by file TAN. RB. 
Logical record HSINE is replaced by the file mounted in the paper 
tape reader. $PTR. Logical record ACOS is replaced by file 
XJIB. 

Note that all these replacements will be made regardless of the 
order of the specified logical records on the input file. 
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Command: 



Title (T) 



Purpose : To produce a title (. TITL) listing of logical records of one or more 

input libraries. 



Format: 



LFE T inputname [ outputname /L] [ inputname] ... 

where: inputname is the name of the file containing an input 
library , 



outputname is the name of the device that is to produce the 
listing. 

Switches : ,/L indicates the listing device. The listing device argument 

may appear anywhere in the command line after the function 
key T. 

Example : LFE T $LPT/L $PTR Fl.LB $TTR ^ 

The library file is $PTR. Additional library files are Fl.LB 
and $TTR. Titles are listed on the line printer. 
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Command: 



Extract (X) 



Purpose : To permit one or more logical records on a library file 

to be extracted as separate relocatable binary files. The relocatable 
binary files will have the file names of the logical records to be ex- 
tracted. 



Format: 



Switches: 



LFE X inputname recordname [ recordname . . . ] 

where: inputname is the name of the file containing the library from 
which records are to be extracted 

recordname is the name of a record to be extracted from the 



input library file. 



None. 



Example: LFE X MATH. LB SINE COSIN: TAN } 



Library file MATH. LB is searched and the logical records 
SINE, COSIN. and TAN are extracted, creating relocatable 
binary files SINE. RB, COSIN. RB, and TAN. RB. 
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ERROR MESSAGES 

The following messages result from encountering fatal errors in the LFE command 
string. A return to the CLI without processing any files will result. 

NOT ENOUGH ARGUMENTS 

For example, unpaired arguments to the replace (R) function. 

UNEXPECTED ARGUMENT AT OR FOLLOWING: string 

For example, filename /A followed by filename /A for an insert 
(I) function. 

When there is no string following the colon in the error message, 
the message indicates the error occurred at the end of the 
command line. 

tmvat rn QWT r rr , H pnc cf-T-; no . 

For example, a switch other than /M in the analyze (A) function 
will cause the following message: ILLEGAL SWITCH FOR: A . 

NOT A LFE COMMAND: kev_ 

A command key that is not recognized by the LFE; currently, 
any letter key other than A, D, I, M, N, R, T, or X causes 
the error. 

TOO MANY ARGUMENTS 

The argument string is too long for the allocated storage (cur- 
rently, 500 characters. ) 

ILLEGAL HEADER IN INPUT LIBRARY. 

No header or an incorrect header block in the library file. 

The following messages result from fatal errors encountered while processing files. 
When these errors occur, the output file will be terminated with a binary end block 
before returning to the CLI. 

CHECKSUM ERROR IN UPDATE FILE: filename 

Typically, the message indicates a bad record within filename. 
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ERROR MESSAGES (Continued) 

CHECKSUM ERROR IN LOGICAL RECORD: recordname 

Very likely the message indicates a bad record. If the checksum 
occurs within a title block itself, recordname will be the name of 
the previous logical record. If no previous record exists, record - 
name will be the name of the library itself. 

ILLEGAL BLOCK UPDATE FILE: filename 

For example, if a source file is specified as input instead of a 
binary file, illegal blocks will be encountered. 

ILLEGAL BLOCK IN LOGICAL RECORD: recordname 

A bad block within a logical record will produce this message. 
If the expected title is missing, the record name will be the name 
of the previous logical record within the library. 

The following message indicates a fatal error detected by the 'system* rather than 
LFE: 

FILE DOES NOT EXIST, FILE: filename 

filename indicates a library file. The error occurs when no 
input file is found for the command. The error can occur 
on command lines having commands other than new (N). 

Other fatal errors from the 'system' will refer to the LFE. SV file. 

CAUTION MESSAGES 

The following messages result from non-fatal errors. Processing will continue 
as indicated for each error. 

FILE DOES NOT EXIST, FILE: filename 



An update file cannot be found. Search is made for filename and 
filename . RB. When not found, the file is omitted in processing. 

LOGICAL RECORD NOT FOUND - recordname 

The input master does not contain recordname . The record (and 
any corresponding argument) are passed in processing. 



3-16 



CAUTION MESSAGES (Continued) 

DEFAULT OUTPUT IN FILE - filename 

An output file specification was expected and not found, filename 
is used instead as the output file. " 

FILE ALREADY EXISTS - filename 

On an extract (X) command there is already a file on the output 
device with the same name as the logical record to be extracted. 
The logical record is omitted in processing. 

UPDATE FILE MATCHES INPUT MASTER: filename 

The result is non-fatal as long as there exists at least one valid 
update file argument. In this case, the matching update file is 
ignored. 



3-17 



INDEX 



A (Analyze) command 2-4, 3-4 

binary 1 -2 

caution messages 2-17, 3-16 

COM. CM 3-1 

command 

descriptions 2-4, 3-3 
file 3-1 

ke^' letters 2-1* 3-1 
string 2-2, 3-2 
structure 2-2, 3-2 
summary 2-1, 3-1 

command line interpreter (CLI) 3-1 

command string corrections 2-3, 3-3 

control A 2-2 

D (Delete) command 2-7, 3-7 

D (external Displacement) 2-4, 3-4 

device names 2-2 

ED (Entry Displacement) 2-4,3-4 

EN (Entry Normal) 2-4,3-4 

EO (Entry Overlay) 2-4, 3-4 

error messages 2-14, 3-15 

I (insert) command 2-8, 3-8 

LB. ST 2-16 

letter switches 2-3, 3-3 

library 1-1 

logical record 1-2 

M (Merge) command 2-10, 3-10 

M (Multiply defined entry) 2-4,3-4 

N (New) command 3-11 

N (external Normal) 2-4, 3-4 



numeric switches 2-3, 3-3 
operator cue messages 2-17 
P (phase error) 2-5, 3-4 

pi.Ug.l_ dill J-ClCJ-Clll^JUiy _L-_i 

R (Replace) command 2-11, 3-12 

RDOS LFE 

loading 3-1 
operation 3-1 
prompt 3-1 

record names 2 -3 

selective loading 1 -1 

stand-alone LFE 

loading 2-1 
operation 2-1 
prompt 2-1 

T (Title) command 2-12,3-13 

T (Title of record) 2-4, 3-4 

T T /T T 1 . /*• _ 1 . \ r\ r- rs a 

u vunueimeu entry; z-o, o~* 

update 1 -2 

X (eXtract) command 2-12, 3-13 



1-1 



0) i 

•ol 

■81 



3 



DATA GENERAL CORPORATION 

PROGRAMMING DOCUMENTATION 

REMARKS FORM 



DOCUMENT TITLE 



DOCUMENT NUMBER (lower righthand corner of title page) 
TAPE NUMBER (if applicable) 



Specific Comments . List specific comments. Reference page numbers when 
applicable. Label each comment as an addition, deletion, change or error 
if applicable. 



General Comments and Suggestions for Improvement of the Publication . 



FROM: Name: Date: 

Title: ____ 

Company: 

Address: 



FOLD DOWN 



FIRST 



FOLD DOWN 



BUSINESS REPLY MAIL 



FIRST 

CLASS 

PERMIT 

No. 26 

Southboro 

Mass. 01 772 



No Postage Necessary If Mailed In The United States 



Postage will be paid by: 

Data General Corporati 

Southboro, Massachusetts 01 772 



ATTENTION: Programming Documentation 



FOLD UP 



SECOND 



FOLD UP 



STAPLE 



